Add Drop-downs to a Ribbon Panel

Drop-downs can be used to group multiple related commands into a single button.

Ribbon panel drop-downs, like toolbar flyouts, that can hold a number of commands in a single place on a ribbon panel. Drop-downs are used to help reduce the amount of space that related commands can take up. Commands on a drop-down can be started by clicking the main button or selecting a command from the menu when the main or split button is clicked based on how the properties of a drop-down are configured. When a drop-down is set as a split button, the main button can reflect the most recently used command or not, or display the image of the most recently used command with a static label.

The following table describes the properties for the Arc drop-down of Row 1 on under Sub-Panel 1 of the Home 2D - Draw ribbon panel as they appear in the Properties pane.

Properties for the Arc Drop-down on Row 1 of the Home 2D - Draw Ribbon Panel
Properties Pane Item	Description	Example
Name	Logical name for the drop-down; does not appear in the user interface. NoteThe “\n” character sequence represents a line break in a command label, which is used to allow a command label to be displayed on more than one line. Once focus from the Name field is lost, the “\n” character sequence is displayed as a space instead of the characters “\n”.	Arc
Description	Text used to describe the element; does not appear in the user interface.
Behavior	Specifies if the button executes a command or displays a list of commands. The available options are Drop Down Menu with Recent, Drop Down Menu, Split with Recent, Split, Split with Recent (Static).	Split with Recent
Split Button List Style	Specifies how the commands on the drop-down will be displayed. The available options are Icon, IconText, or Descriptive.	IconText
Button Style	Controls the size and the label display of the drop-down. The available options are Large With Text (Vertical), Large With Text (Horizontal), SmallWithText, or SmallWithoutText. NoteIt is recommended to not use the Large With Text (Horizontal) option as it takes up extra space on the ribbon.	Large with Text (Vertical)
Grouping	Controls whether the commands assigned to a drop-down are grouped based on the values assigned to their Group Name properties.	No
KeyTip	Specifies the keytip characters that can be used to access the command from the keyboard.	AR
Tooltip Title	Text string that controls the title of the tooltip for the command.
Element ID	Tag that uniquely identifies a panel section.	ID_RBN_SPLITBTN_ARC
Small Image	ID string of the small-image resource (16 × 16 bitmap). The string must include alphanumeric characters with no punctuation other than a hyphen (-) or an underscore (_). It can also be a user-defined bitmap. Click the […] button to open the Select Image File dialog box.	RCDATA_16_ARC3PT
Large Image	ID string of the large-image resource (32 × 32 bitmap). If the specified bitmap is not 32 × 32, the program scales it to that size. The string must include alphanumeric characters with no punctuation other than a hyphen (-) or an underscore (_). It can also be a user-defined bitmap. Click the […] button to open the Select Image File dialog box.	RCDATA_16_ARC3PT

See Also

To create a drop-down in a row on a ribbon panel (Procedure)

Procedure

To create a drop-down in a row on a ribbon panel

Click Manage tab Customization panel User Interface. At the Command prompt, enter cui.
In the Customize User Interface Editor, Customize tab, in the Customizations In <file name> pane, click the plus sign (+) next to Ribbon to expand it.
Click the plus sign (+) next to Panels to expand it.
Click the plus sign (+) next to the ribbon panel where you want to add a drop-down.
Right-click the row to which you want to add a drop-down. Click New Drop-down.

A new drop-down (named New Drop-down) is created in the last position of the row.
Right-click the new drop-down. Click Rename. Enter a new name.
In the Command List pane, drag the commands that you want to add to the new drop-down in the Customizations In <file name> pane.
Adjust the properties of the drop-down as desired to control the appearance of the drop-down and the commands under the drop-down.
If the drop-down will use the Split behavior, add a command to the Primary Command node under the drop-down to set the command for the main button.
Click Apply.

Quick Reference

Commands